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Introduction 



The ESV Workstation supports PEX (PHIGS Extension to X), which gives the user access to 
the X Window System, the PHIGS (Programmer's Hierarchical Interactive Graphics System) 
standard interface, and the proposed PHIGS PLUS (PHIGS Plus Lumiere und Surfaces) standard. 

PEX has not yet been released by the X Consortium. Evans & Sutherland is a sponsor of 
the X Consortium, and ES/PEX is based on the PEX PR2.0 sample implementation from the 
X Consortium. Evans & Sutherland will continue to follow the PEX development, and, 
upon release of the PEX extension to public domain, will provide a PEX-compatible server 
on the ESV Workstation. 

Since the Application Programmers Interface (API) for the C language to PHIGS and 
PHIGS PLUS is not yet an official standard, the PEX development work by the X Consortium 
is being done using the Sun-defined C language interface. This is also the interface currently 
used by ES/PEX. 

Caution: It should be emphasized that PEX is still in the 

development period, and it is not yet a standard. 
Therefore, programs that run under the current release of 
ES/PEX may have to be recompiled or altered for future 
releases. 
This document contains the following sections: 

"What Is PEX?" describes the X Model, the PHIGS Model, and the PEX Model. 

"Functional Overview" contains a general discussion of the ES/PEX function types 
supported by the ESV Workstation. 

"PHIGS and PHIGS PLUS Functions" contains a list of all of the PHIGS and PHIGS 
PLUS functions and identifies those that are not currently supported. 

"OPEN PEX" describes the OPEN PEX function. 

"OPEN WORKSTATION" describes the OPEN WORKSTATION function. 

"Function Numbers" contains a list of the function numbers with the corresponding 
function name. Function numbers are returned with error messages. 

"Error Messages" contains a list of the error numbers with the corresponding error 
description. Error numbers are returned with error messages. 

"PHIGS and PHIGS PLUS Tables" contains the PHIGS Description Table, PHIGS 
PLUS Description Table, PHIGS Workstation Description Table, and the PHIGS PLUS 
Workstation Description Table. 



What Is PEX? 



The X Model 



The X Window System is a publicly available protocol that supports 2D graphics. PEX is an 
extension to the X Window System which allows X to support 3D graphics and gives a user 
application access to the PHIGS and PHIGS PLUS functions. To understand PEX, we must 
first look at the X Model and the PHIGS Model. Figure 1 shows a simplified schematic of 
the X Model, Figure 2 shows a simplified schematic of the PHIGS Model, and Figure 3 
shows a simplified schematic of the PEX Model. 



The X Model is divided into two parts: the client and the server. The server controls the 
graphics display and is the interface between the client and the graphics display. The client is 
a user application that may or may not be running on the same system as the graphics display. 

The X Window System defines the device-independent protocol between the client and 
the server. Xlib and the X Server are sample implementations of the X Protocol on a 
specific system, such as the ESV Workstation, and are device dependent. A user application 
calls the Xlib functions, which, in turn, generate data packets defined by the X Protocol. 
The X Server translates these data packets into commands that control the graphics display. 



The PHIGS Model 



PHIGS is a functional specification defining the interface between a user application and the 
graphics system that displays the application. PHIGS is device independent. 

PHIGS creates application data structures that are stored in an area called the central 
store structure (CSS), which is also created by PHIGS. The data structures can be posted to 
one or more workstations, or devices, which are also created by PHIGS. A workstation may 
or may not be equivalent to a hardware system, such as the ESV Workstation. 



The PEX Model 



The X Window System permits the addition of extensions, which are also protocols. PEX is 
one extension. Other extensions on the ESV Workstation include the X Input Extension and 
the X Picking Extension. PEX is an addition to the X Protocol which gives a user 
application access to the X Window System through PHIGS and PHIGS PLUS functions. 

With the PEX, X Input, and X Picking extensions added to the X Window System, a 
user application has access to the Xlib functions, the PHIGS and PHIGS PLUS functions, and 
the X Input and X Picking functions. An application call to a PHIGS or PHIGS PLUS 
function is translated into a PEX protocol data packet which is sent to the X Server through 
Xlib. The X Server recognizes the data packet as being from PEX and transfers it to the 
PEX routines in the X Server for processing. The X Input and X Picking data packets are 
processed in a similar manner. 

If a PHIGS workstation is created on the ESV Workstation, the display surface of the 
PHIGS workstation will be mapped to an X window that is opened on the ESV Workstation. 
If the PHIGS workstation is closed, the X window will remain open but will revert to a 2D 
window. 
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Figure 1. The X Model 
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Figure 2. The PHIGS Model 
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Figure 3. The PEX Model 



Functional Overview 



PHIGS and PHIGS PLUS capabilities are expressed by functions and the parameter ranges of 
those functions. It should be understood that not all implementations will be able to 
support all capabilities. The PHIGS standard outlines a set of minimum support criteria; and, 
depending on the implementation, the parameter range provided by a specific implementation 
may exceed the minimum criteria. 

The following list is a very generalized oudine of the PHIGS and PHIGS PLUS 
functionality not currently supported by the ES V Workstation. 

Archival 

B -spline curves and surfaces 

Cell arrays 

Curve and surface approximation by subdivision 

Escapes 

Generalized drawing primitives 

Generalized structure elements 

Incremental spatial search 

Input 

Line width 

Metafiles 

Model space clip 

Non-default line types 

Non-default marker types 

Patterning and hatching of fill areas 

Phong or dot product shading 

Quadrilateral mesh 

Raster or polygon text 

Text precision other than stroke 

Triangle strip 

4 

Trimming curves 



Interior Styles 



The ESV Workstation supports interior styles Solid, Empty, and Hollow. 



Light Source Types and Table Indices 

The ESV Workstation supports the following light source types: 
• ambient (l) 

directional (vector) (2) 
positional (point) (3) 
positional (spot) (4) 



Linetypes and Edgetypes 

The ES V Workstation supports the following four required edgetypes and linetypes: 

• solid (1) 

• dashed (2) 

• dotted (3) 

• dashed-dotted (4) 

Predefined Polyline Bundles 

The ESV Workstation supports the following five linetypes: solid, dashed, dotted, dot- 
dashed, and long-dashed. At present, the ESV Workstation does not support the 
following three linetypes: dot-dashed-dot-dotted, center, and phantom. 

Text Font and Precision Pairs 

The ESV Workstation supports one distinct text font (1). This font supports the Stroke 
precision only. 

Workstation Category and Type 

The ESV Workstation only supports a workstation of type OUTPUT. The X Input 
Extension and X Picking Extension are used for input. 



PHIGS/PHIGS PLUS Functions 



In the following list, functions shown in bold are currently supported by the ES V 
Workstation, and functions shown in italics are not currently supported by the ES V 
Workstation. PHIGS PLUS functions are indicated with a (+). The OPEN PH1GS function 
is supported only through the OPEN PEX function. 

Function Name 

ADD NAMES TO SET 
ANNOTATION TEXT RELATIVE 
ANNOTATION TEXT RELATIVE 3 
APPLICATION DATA 

ARCHIVE ALL STRUCTURES 

ARCHIVE STRUCTURE NETWORKS 

ARCHIVE STRUCTURES 

AWAIT EVENT 

BUILD TRANSFORMATION MATRIX 

BUILD TRANSFORMATION MATRIX 3 

CELL ARRAY 

CELL ARRAY 3 

CHANGE STRUCTURE IDENTIFIER 

CHANGE STRUCTURE IDENTIFIER AND REFERENCES 

CHANGE STRUCTURE REFERENCES 

CLOSE ARCHIVE FILE 

CLOSE PHIGS 

CLOSE STRUCTURE 

CLOSE WORKSTATION 

COMPOSE MATRIX 

COMPOSE MATRIX 3 

COMPOSE TRANSFORMATION MATRIX 

COMPOSE TRANSFORMATION MATRIX 3 

COMPUTE FILL AREA SET GEOMETRIC NORMAL (+) 

COPY ALL ELEMENTS FROM STRUCTURE 

DELETE ALL STRUCTURES 

DELETE ALL STRUCTURES FROM ARCHIVE 

DELETE ELEMENT 

DELETE ELEMENT RANGE 

DELETE ELEMENTS BETWEEN LABELS 

DELETE STRUCTURE 

DELETE STRUCTURE NETWORK 

DELETE STRUCTURE NETWORKS FROM ARCHIVE 

DELETE STRUCTURES FROM ARCHIVE 

ELEMENT SEARCH 

EMERGENCY CLOSE PHIGS 

EMPTY STRUCTURE 

ERROR HANDLING 

ERROR LOGGING 



ESCAPE 

EVALUATE VIEW MAPPING MATRIX 

EVALUATE VIEW MAPPING MATRIX 3 

EVALUATE VIEW ORIENTATION MATRIX 

EVALUATE VIEW ORIENTATION MATRIX 3 

EXECUTE STRUCTURE 

EXTENDED CELL ARRAY3(+) 

FILL AREA 

FILL AREA 3 

FILL AREA 3 WITH DATA (+) 

FILL AREA SET 

FILL AREA SET 3 

FILL AREA SET 3 WITH DATA (+) 

FLUSH DEVICE EVENTS 

GENERALIZED DRAWING PRIMITIVE 

GENERALIZED DRAWING PRIMITIVE 3 

GENERALIZED STRUCTURE ELEMENT 

GET CHOICE 

GET ITEM TYPE FROM METAFILE 

GET LOCATOR 

GET LOCATOR 3 

GET PICK 

GET STRING 

GET STROKE 

GET STROKE 3 

GET VALUATOR 

INCREMENTAL SPATIAL SEARCH 

INCREMENTAL SPATIAL SEARCH 3 

INITIALIZE CHOICE 

INITIALIZE CHOICE 3 

INITIALIZE LOCATOR 

INITIALIZE LOCATOR 3 

INITIALIZE PICK 

INITIALIZE PICK 3 

INITIALIZE STRING 

INITIALIZE STRING 3 

INITIALIZE STROKE 

INITIALIZE STROKE 3 

INITIALIZE VALUATOR 

INITIALIZE VALUATOR 3 

INQUIRE ALL CONFLICTING STRUCTURES 

INQUIRE ANNOTATION FACILITIES 

INQUIRE ARCHIVE FILES 

INQUIRE ARCHIVE STA TE VAL UE 

INQUIRE CHOICE DEVICE STATE 

INQUIRE CHOICE DEVICE STATE 3 



INQUIRE COLOUR FACILITIES 

INQUIRE COLOUR MAPPING FACILITIES (+) 

INQUIRE COLOUR MAPPING METHOD FACILITIES (+) 

INQUIRE COLOUR MAPPING REPRESENTA TION (+) 

INQUIRE COLOUR MAPPING STATE (+) 

INQUIRE COLOUR MODEL 

INQUIRE COLOUR MODEL FACILITIES 

INQUIRE COLOUR REPRESENTATION 

INQUIRE CONFLICT RESOLUTION 

INQUIRE CONFLICTING STRUCTURES IN NETWORK 

INQUIRE CURRENT ELEMENT CONTENT 

INQUIRE CURRENT ELEMENT TYPE AND SIZE 

INQUIRE CURVE AND SURFACE FACILITIES (+) 

INQUIRE DEFAUL T CHOICE DEVICE DATA 

INQUIRE DEFAUL T CHOICE DEVICE DATA 3 

INQUIRE DEFAUL T DISPLAY UPDATE STATE 

INQUIRE DEFAULT LOCATOR DEVICE DATA 

INQUIRE DEFAULT LOCATOR DEVICE DATA 3 

INQUIRE DEFAUL T PICK DEVICE DA TA 

INQUIRE DEFAUL T PICK DEVICE DATA 3 

INQUIRE DEFAUL T STRING DEVICE DA TA 

INQUIRE DEFAUL T STRING DEVICE DATA 3 

INQUIRE DEFAUL T STROKE DEVICE DA TA 

INQUIRE DEFAULT STROKE DEVICE DATA 3 

INQUIRE DEFAULT VALUATOR DEVICE DATA 

INQUIRE DEFAUL T VALUATOR DEVICE DATA 3 

INQUIRE DEPTH CUE FACILITIES (+) 

INQUIRE DEPTH CUE REPRESENTATION (+) 

INQUIRE DIRECT COLOUR MODEL FACILITIES (+) 

INQUIRE DISPLAY SPACE SIZE 

INQUIRE DISPLAY SPACE SIZE 3 

INQUIRE DISPLAY UPDATE STATE 

INQUIRE DYNAMICS OF STRUCTURES 

INQUIRE DYNAMICS OF WORKSTATION ATTRIBUTES 

INQUIRE EDGE FACILITIES 

INQUIRE EDGE REPRESENTATION 

INQUIRE EDIT MODE 

INQUIRE ELEMENT CONTENT 

INQUIRE ELEMENT POINTER 

INQUIRE ELEMENT TYPE AND SIZE 

INQUIRE ERROR HANDLING MODE 

INQUIRE EXTENDED DYNAMICS OF WORKSTATION ATTRIBUTES (+) 

INQUIRE EXTENDED EDGE REPRESENTATION (+) 

INQUIRE EXTENDED INTERIOR FACILITIES (+) 

INQUIRE EXTENDED INTERIOR REPRESENTATION (+) 

INQUIRE EXTENDED PATTERN REPRESENTATION (+) 
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INQUIRE EXTENDED POLYLINE FACILITIES (+) 

INQUIRE EXTENDED POLYLINE REPRESENTATION (+) 

INQUIRE EXTENDED POLYMARKER REPRESENTATION (+) 

INQUIRE EXTENDED TEXT REPRESENTATION (+) 

INQUIRE EXTENDED WORKSTATION STATE TABLE LENGTHS (+) 

INQUIRE GENERALIZED DRAWING PRIMITIVE 

INQUIRE GENERALIZED DRAWING PRIMITIVE 3 

INQUIRE GENERALIZED STRUCTURE ELEMENT FACILITIES 

INQUIRE HIGHLIGHTING FILTER 

INQUIRE HLHSR FACILITIES 

INQUIRE HLHSR MODE 

INQUIRE INPUT QUEUE OVERFLOW 

INQUIRE INTERIOR FACILITIES 

INQUIRE INTERIOR REPRESENTATION 

INQUIRE INVISIBILITY FILTER 

INQUIRE LIGHT SOURCE FACILITIES (+) 

INQUIRE LIGHT SOURCE REPRESENTATION (+) 

INQUIRE LIST OF AVAILABLE GENERALIZED DRAWING PRIMITIVES 

INQUIRE LIST OF AVAILABLE GENERALIZED DRAWING PRIMITIVES 3 

INQUIRE LIST OF AVAILABLE GENERALIZED STRUCTURE ELEMENTS 

INQUIRE LIST OF AVAILABLE WORKSTATION TYPES 

INQUIRE LIST OF COLOUR INDICES 

INQUIRE LIST OF COLOUR MAPPING INDICES (+) 

INQUIRE LIST OF DEPTH CUE INDICES (+) 

INQUIRE LIST OF EDGE INDICES 

INQUIRE LIST OF INTERIOR INDICES 

INQUIRE LIST OF LIGHT SOURCE INDICES (J ' 

INQUIRE LIST OF PATTERN INDICES 

INQUIRE LIST OF POL YLINE INDICES 

INQUIRE LIST OF POL YMARKER INDICES 

INQUIRE LIST OF TEXT INDICES 

INQUIRE LIST OF VIEW INDICES 

INQUIRE LOCATOR DEVICE STATE 

INQUIRE LOCATOR DEVICE STATE 3 

INQUIRE MODELLING CLIPPING FACILITIES 

INQUIRE MORE SIMULTANEOUS EVENTS 

INQUIRE NUMBER OF AVAILABLE LOGICAL INPUT DEVICES 

INQUIRE NUMBER OF DISPLAY PRIORITIES SUPPORTED 

INQUIRE OPEN STRUCTURE 

INQUIRE PATHS TO ANCESTORS 

INQUIRE PATHS TO DESCENDANTS 

INQUIRE PATTERN FACILITIES 

INQUIRE PATTERN REPRESENTATION 

INQUIRE PHIGS FACILITIES 

INQUIRE PICK DEVICE STATE 

INQUIRE PICK DEVICE STATE 3 
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INQUIRE POLYLINE FACILITIES 

INQUIRE POLYLINE REPRESENTATION 

INQUIRE POLYMARKER FACILITIES 

INQUIRE POLYMARKER REPRESENTATION 

INQUIRE POSTED STRUCTURES 

INQUIRE PREDEFINED COLOUR MAPPING REPRESENTATION (+) 

INQUIRE PREDEFINED COLOUR REPRESENTATION 

INQUIRE PREDEFINED DEPTH CUE REPRESENTATION (+) 

INQUIRE PREDEFINED EDGE REPRESENTATION 

INQUIRE PREDEFINED EXTENDED EDGE REPRESENTATION (+) 

INQUIRE PREDEFINED EXTENDED INTERIOR REPRESENTATION (+) 

INQUIRE PREDEFINED EXTENDED PATTERN REPRESENTATION (+) 

INQUIRE PREDEFINED EXTENDED POLYLINE REPRESENTATION (+) 

INQUIRE PREDEFINED EXTENDED POLYMARKER REPRESENTATION (+) 

INQUIRE PREDEFINED EXTENDED TEXT REPRESENTATION (+) 

INQUIRE PREDEFINED INTERIOR REPRESENTATION 

INQUIRE PREDEFINED LIGHT SOURCE REPRESENTATION (+) 

INQUIRE PREDEFINED PATTERN REPRESENTATION 

INQUIRE PREDEFINED POLYLINE REPRESENTATION 

INQUIRE PREDEFINED POLYMARKER REPRESENTATION 

INQUIRE PREDEFINED TEXT REPRESENTATION 

INQUIRE PREDEFINED VIEW REPRESENTATION 

INQUIRE RENDERING COLOUR MODEL FACILITIES (+) 

INQUIRE SET OF OPEN WORKSTATIONS 

INQUIRE SET OF WORKSTATIONS TO WHICH POSTED 

INQUIRE STRING DEVICE STATE 

INQUIRE STRING DEVICE STATE 3 

INQUIRE STROKE DEVICE STATE 

INQUIRE STROKE DEVICE STATE 3 

INQUIRE STRUCTURE IDENTIFIERS 

INQUIRE STRUCTURE STATE VALUE 

INQUIRE STRUCTURE STATUS 

INQUIRE SYSTEM STATE VALUE 

INQUIRE TEXT EXTENT 

INQUIRE TEXT FACILITIES 

INQUIRE TEXT REPRESENTATION 

INQUIRE VALUATOR DEVICE STATE 

INQUIRE VALUATOR DEVICE STATE 3 

INQUIRE VIEW FACILITIES 

INQUIRE VIEW REPRESENTATION 

INQUIRE WORKSTATION CATEGORY 

INQUIRE WORKSTATION CLASSIFICATION 

INQUIRE WORKSTATION CONNECTION AND TYPE 

INQUIRE WORKSTATION STATE TABLE LENGTHS 

INQUIRE WORKSTATION STATE VALUE 

INQUIRE WORKSTATION TRANSFORMATION 
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INQUIRE WORKSTATION TRANSFORMATION 3 

INTERPRET ITEM 

LABEL 

MESSAGE 

OFFSET ELEMENT POINTER 

OPEN ARCHIVE FILE 

OPEN PHIGS 

OPEN STRUCTURE 

OPEN WORKSTATION 

NON-UNIFORM B-SPLINE CURVE (+) 

NON-UNIFORM B-SPLINE SURFACE (+) 

POLYLINE 

POLYLINE 3 

POLYLINE SET 3 WITH DATA (+) 

POLYMARKER 

POLYMARKER 3 

POST STRUCTURE 

QUADRILATERAL MESH 3 WITH DATA (+) 

READ ITEM FROM METAFILE 

REDRAW ALL STRUCTURES 

REMOVE NAMES FROM SET 

REQUEST CHOICE 

REQUEST LOCATOR 

REQUEST LOCATOR 3 

REQUEST PICK 

REQUEST STRING 

REQUEST STROKE ,# 

REQUEST STROKE 3 

REQUEST VALUATOR 

RESTORE MODELLING CLIPPING VOLUME 

RETRIEVE ALL STRUCTURES 

RETRIEVE ANCESTORS OF STRUCTURE 

RETRIEVE DESCENDANTS OF STRUCTURE 

RETRIEVE STRUCTURE IDENTIFIERS 

RETRIEVE STRUCTURE NETWORKS 

RETRIEVE STRUCTURES 

ROTATE 

ROTATE X 

ROTATE Y 

ROTATE Z 

SAMPLE CHOICE 

SAMPLE LOCATOR 

SAMPLE LOCATOR 3 

SAMPLE PICK 

SAMPLE STRING 

SAMPLE STROKE 
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SAMPLE STROKE 3 

SAMPLE VALUATOR 

SCALE 

SCALE 3 

SET ANNOTATION STYLE 

SET ANNOTATION TEXT ALIGNMENT 

SET ANNOTATION TEXT CHARACTER HEIGHT 

SET ANNOTATION TEXT CHARACTER UP VECTOR 

SET ANNOTATION TEXT PATH 

SET AREA PROPERTIES (+) 

SET BACK AREA PROPERTIES (+) 

SET BACK INTERIOR COLOUR (+) 

SET BACK INTERIOR REFLECTANCE EQUATION (+) 

SET BACK INTERIOR SHADING METHOD (+) 

SET BACK INTERIOR STYLE (+) 

SET BACK INTERIOR STYLE INDEX (+) 

SETBACK PARAMETRIC SURFACE CHARACTERISTICS (+) 

SET CHARACTER EXPANSION FACTOR 

SET CHARACTER HEIGHT 

SET CHARACTER SPACING 

SET CHARACTER UP VECTOR 

SET CHOICE MODE 

SET COLOUR MAPPING INDEX (+) 

SET COLOUR MAPPING REPRESENTATION (+) 

SET COLOUR MODEL 

SET COLOUR REPRESENTATION 

SET CONFLICT RESOLUTION 

SET CURVE APPROXIMATION CRITERIA (+) 

SET DEPTH CUE INDEX (+) 

SET DEPTH CUE REPRESENTATION (+) 

SET DISPLAY UPDATE STATE 

SET EDGE COLOUR (+) 

SET EDGE COLOUR INDEX 

SET EDGE FLAG 

SET EDGE INDEX 

SET EDGE REPRESENTATION 

SET EDGETYPE 

SET EDGEWIDTH SCALE FACTOR 

SET EDIT MODE 

SET ELEMENT POINTER 

SET ELEMENT POINTER AT LABEL 

SET ERROR HANDLING MODE 

SET EXTENDED EDGE REPRESENTATION (+) 

SET EXTENDED INTERIOR REPRESENTATION (+) 

SET EXTENDED PATTERN REPRESENTATION (+) 
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SET EXTENDED POLYLINE REPRESENTATION (+) 

SET EXTENDED POLYMARKER REPRESENTATION (+) 

SET EXTENDED TEXT REPRESENTATION (+) 

SET FACE CULLING MODE (+) 

SET FACE DISTINGUISHING MODE (+) 

SET GLOBAL TRANSFORMATION 

SET GLOBAL TRANSFORMATION 3 

SET HIGHLIGHTING FILTER 

SET HLHSR IDENTIFIER 

SET HLHSR MODE 

SET INDIVIDUAL ASF 

SET INTERIOR COLOUR (+) 

SET INTERIOR COLOUR INDEX 

SET INTERIOR INDEX 

SET INTERIOR REFLECTANCE EQUATION (+) 

SET INTERIOR REPRESENTATION 

SET INTERIOR SHADING METHOD (+) 

SET INTERIOR STYLE 

SET INTERIOR STYLE INDEX 

SET INVISIBILITY FILTER 

SET LIGHT SOURCE REPRESENTATION (+) 

SET LIGHT SOURCE STATE (+) 

SET LINETYPE 

SET LINEWIDTH SCALE FACTOR 

SET LOCAL TRANSFORMATION j 

SET LOCAL TRANSFORMATION 3 

SET LOCATOR MODE 

SET MARKER SIZE SCALE FACTOR 

SET MARKER TYPE 

SET MODELLING CLIPPING INDICATOR 

SET MODELLING CLIPPING VOLUME 

SET MODELLING CLIPPING VOLUME 3 

SET OF FILL AREA SET 3 WITH DATA (+) 

SET PARAMETRIC SURFACE CHARACTERISTICS (+) 

SET PATTERN REFERENCE POINT 

SET PATTERN REFERENCE POINT AND VECTORS 

SET PA TTERN REPRESENTA TION 

SET PATTERN SIZE 

SET PICK FILTER 

SET PICK IDENTIFIER 

SET PICK MODE 

SET POLYLINE COLOUR (+) 

SET POLYLINE COLOUR INDEX 

SET POLYLINE INDEX 



15 



SET POLYLINE REPRESENTATION 

SET POLYLINE SHADING METHOD (+) 

SET POLYMARKER COLOUR (+) 

SET POLYMARKER COLOUR INDEX 

SET POLYMARKER INDEX 

SET POLYMARKER REPRESENTATION 

SET RENDERING COLOUR MODEL (+) 

SET STRING MODE 

SET STROKE MODE 

SET SURFACE APPROXIMATION CRITERIA (+) 

SET TEXT ALIGNMENT 

SET TEXT COLOUR (+) 

SET TEXT COLOUR INDEX 

SET TEXT FONT 

SET TEXT INDEX 

SET TEXT PATH 

SET TEXT PRECISION 

SET TEXT REPRESENTATION 

SET TRIMMING CURVE APPROXIMATION CRITERIA (+) 

SET VALUATOR MODE 

SET VIEW INDEX 

SET VIEW REPRESENTATION 

SET VIEW REPRESENTATION 3 

SET VIEW TRANSFORMATION INPUT PRIORITY 

SET WORKSTATION VIEWPORT 

SET WORKSTATION VIEWPORT 3 

SET WORKSTATION WINDOW 

SET WORKSTATION WINDOW 3 

TEXT 

TEXT 3 

TRANSFORM POINT 

TRANSFORM POINT 3 

TRANSLATE 

TRANSLATE 3 

TRIANGLE STRIP 3 WITH DATA (+) 

UNPOST ALL STRUCTURES 

UNPOST STRUCTURE 

UPDATE WORKSTATION 

WRITE ITEM TO METAFILE 
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OPEN PEX 



Name 



OPEN PEX - open and initialize the PEX environment 



Synopsis 



Syntax 



void 

popenpex(error_file,memory) 
Pchar *error_file; 

Plong memory; 

Popenpexi nf o *xi nf o ; 



Input Parameters 
error file 



memory 
xinfo 



error_file is a pointer to the error file where PEX error messages are 
logged. The error file can be either a pointer to a valid UNIX file name or a 
null pointer (e.g., (Pchar*)0). A null pointer implies that standard error 
is to be used as the error file. If a file name is specified, PEX will attempt 
to access the file for writing. If this attempt fails, OPEN PEX will fail 
and the appropriate error will be reported to standard error. 

The error file argument passed to OPEN PEX will be passed to ERROR 
HANDLING. ERROR HANDLING will also pass this argument to 
ERROR LOGGING. If for some reason ERROR LOGGING cannot access 
the specified error file, the error message will be written to standard 
error. ERROR LOGGING appends messages to the error file, and it does 
not truncate the file when OPEN PfXis called. If the specified file does 
not exist, it will only be created if ERROR LOGGING is called. 

ERROR LOGGING writes the PHIGS or PHIGS PLUS function name, the er- 
ror number, and an error description to the error file. If for some reason 
the text for the function name and/or error description cannot be deter- 
mined, ERROR LOGGING will just write the function number and the er- 
ror number. 

memory is ignored by the API. 

xinfo is a pointer to a Popenpexinfo structure (defined in phigs.h). It 
allows the specification of some runtime options. 



17 



PopenpexinfO Structure 




typedef struct { 




Display 


*display; 


Xrm Database 


rdb; 


char 


*name; 


char 


*classname 


int 


*argc_p; 


char 


**argv; 


struct { 




unsigned no_monitor: 1 ; 


unsigned force_ 


_client_SS; 


} 


flags; 


} Popenpexinfo; 




PopenpexinfO Parameters 




display 


display is 



Execution 



display is the display pointer for the server connection to use, 
rather than creating a connection to the default server. It must 
be either NULL or a valid display pointer. If a valid display 
pointer is specified, then the API will use it as the start-up serv- 
er. If display is NULL, the API will attempt to connect to the 
default server. 



rdb 




rdb is not used. 


name 




name is not used. 


classname 




classname is not used. 


argc_p 




argc_p is not used. 


argv 




argv is not used. 


flags.no_monitor 


This parameter should be set to 1. 


flags.force_ 


_client_SS 


This parameter should be set to 0. 



OPEN PEX initializes the PEX environment and enables access to the PEX functions. 
OPEN PEX must be called prior to calling any other PEX functions. The API makes its 
own connections to X servers during OPEN PEX if a display is not specified. 

A maximum of 14 workstations can be open at any one time. This limit may be reduced, 
however, by the unavailability of operating system or server resources. Open workstations 
may exist on any servers to which the application has access. There is no requirement that 
all workstations be open on a common server. 



After the Popenpexinfo structure is checked, OPEN PEX calls OPEN PHIGS. Errors 
detected during OPEN PHIGS will return the error code associated with OPEN PHIGS, 
not OPEN PEX, even though the application called OPEN PEX. OPEN PHIGS is 
supported only through OPEN PEX. OPEN PHIGS should not be called. 
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OPEN WORKSTATION 



Name 



Synopsis 



OPEN WORKSTATION - create a PHIGS workstation 



Syntax 

void 

popenws(ws_id,conn_id,ws_type) 
Pint ws_id; 

Pconnid conn_id; 

Pwstype ws_type; 

Input Parameters 

WS_id WSjd is the workstation ID. 

COnrMd COnn_id is the connection ID. The drawable and display are specified in this pa- 
rameter. A Pconnid_x_drawabIe structure (defined in phigs.h) should be 
provided for this parameter. Refer to the code example at the bottom of the 
page. 

ws_type ws_type is the available workstation type, phigs_ws_type_x_drawable. 

phigs_ws_type_x_drawable uses the drawable specified in the conn_id for 
the output surface of the workstation. 



Pconnid_x_drawable Structure 

typedef char *Pconnid; 
typedef struct { 

Display "display; 

XID drawablejd; 

} Pconnid_x_drawable; 



/* defined in phigs.h */ 



/* defined in phigs.h */ 



Description 



Following is a code example. 
Pconnid x drawable 



connjd; 



connjd.display = my_open_display; 
conn_id.drawablejd = my_existing_drawable; 
popenws(my_ws_id,(Pconnid*)&conn_id, 
phigs_ws_type_x_drawable); 

The API uses the specified drawable and display for the workstation output surface. 
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Function Numbers 



The function numbers listed in the left-hand column are returned by error messages. The 
corresponding function name is listed in the right-hand column. 

In the following list, PHIGS and PfflGS PLUS functions shown in bold are supported by 
the ES V Workstation, and PfflGS and PfflGS PLUS functions shown in italics are not 
currently supported by the ESV Workstation. PfflGS PLUS functions are indicated with a (+). 

Number Function Name 



-5 


OPEN PEX 





OPEN PHIGS 


1 


CLOSE PHIGS 


2 


OPEN WORKSTATION 


3 


CLOSE WORKSTATION 


4 


REDRAW ALL STRUCTURES 


5 


UPDATE WORKSTATION 


6 


SET DISPLAY UPDATE STATE 


7 


MESSAGE 


8 


POLYLINE 3 


9 


POLYLINE 


10 


POLYMARKER 3 


11 


POLYMARKER 


12 


TEXT 3 


13 


TEXT 


14 


ANNOTATION TEXT RELATIVE 3 


15 


ANNOTATION TEXT RELATIVE 


16 


FILL AREA 3 


17 


FILL AREA 


18 


FILL AREA SET 3 


19 


FILL AREA SET 


20 


CELL ARRAY 3 


21 


CELL ARRAY 


22 


GENERALIZED DRAWING PRIMITIVE 3 


23 


GENERALIZED DRAWING PRIMITIVE 


24 


SET POLYLINE INDEX 


25 


SET POLYMARKER INDEX 


26 


SET TEXT INDEX 


27 


SET INTERIOR INDEX 


28 


SET EDGE INDEX 


29 


SET LINETYPE 


30 


SET LINEWIDTH SCALE FACTOR 


31 


SET POLYLINE COLOUR INDEX 


32 


SET MARKER TYPE 


33 


SET MARKER SIZE SCALE FACTOR 
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Number Function Name 

34 SET POLYMARKER COLOUR INDEX 

35 SET TEXT FONT 

36 SET TEXT PRECISION 

37 SET CHARACTER EXPANSION FACTOR 

38 SET CHARACTER SPACING 

39 SET TEXT COLOUR INDEX 

40 SET CHARACTER HEIGHT 

41 SET CHARACTER UP VECTOR 

42 SET TEXT PATH 

43 SET TEXT ALIGNMENT 

44 SET ANNOTATION TEXT CHARACTER HEIGHT 

45 SET ANNOTATION TEXT CHARACTER UP VECTOR 

46 SET ANNOTATION TEXT PATH 

47 SET ANNOTATION TEXT ALIGNMENT 

48 SET ANNOTATION STYLE 

49 SET INTERIOR STYLE 

50 SET INTERIOR STYLE INDEX 

51 SET INTERIOR COLOUR INDEX 
51 SET EDGE FLAG 

53 SET EDGETYPE 

54 SET EDGEWIDTH SCALE FACTOR 

55 SET EDGE COLOUR INDEX 

56 SET PATTERN SIZE 

57 SET PATTERN REFERENCE POINJ AND VECTORS 

58 SET PA TTERN REFERENCE POINT 

59 ADD NAMES TO SET 

60 REMOVE NAMES FROM SET 

61 SET INDIVIDUAL ASF 

62 SET POLYLINE REPRESENTATION 

63 SET POLYMARKER REPRESENTATION 

64 SET TEXT REPRESENTATION 

65 SET INTERIOR REPRESENTATION 

66 SET EDGE REPRESENTATION 

67 SET PA TTERN REPRESENTA TION 

68 SET COLOUR REPRESENTATION 

69 SET HIGHLIGHTING FILTER 

70 SET INVISIBILITY FILTER 

7 1 SET COLOUR MODEL 

72 SET HLHSR IDENTIFIER 

73 SET HLHSR MODE 

74 SET LOCAL TRANSFORMATION 3 

75 SET LOCAL TRANSFORMATION 
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Number Function Name 

76 SET GLOBAL TRANSFORMATION 3 

77 SET GLOBAL TRANSFORMATION 

78 SET MODELLING CLIPPING VOLUME 3 

79 SET MODELLING CLIPPING VOL UME 

80 SET MODELLING CLIPPING INDICA TOR 

81 RESTORE MODELLING CLIPPING VOLUME 

82 SET VIEW INDEX 

83 SET VIEW REPRESENTATION 3 

84 SET VIEW REPRESENTATION 

85 SET VIEW TRANSFORMATION INPUT PRIORITY 

86 SET WORKSTATION WINDOW 3 

87 SET WORKSTATION WINDOW 

88 SET WORKSTATION VIEWPORT 3 

89 SET WORKSTATION VIEWPORT 

90 OPEN STRUCTURE 

91 CLOSE STRUCTURE 

92 EXECUTE STRUCTURE 

93 LABEL 

94 APPLICATION DATA 

95 GENERALIZED STRUCTURE ELEMENT 

96 SET EDIT MODE 

97 COPY ALL ELEMENTS FROM STRUCTURE 

98 SET ELEMENT POINTER 

99 OFFSET ELEMENT POINTER 

100 SET ELEMENT POINTER AT LABEL 

101 DELETE ELEMENT 

102 DELETE ELEMENT RANGE 

103 DELETE ELEMENTS BETWEEN LABELS 

104 EMPTY STRUCTURE 

105 DELETE STRUCTURE 

106 DELETE STRUCTURE NETWORK 

107 DELETE ALL STRUCTURES 

108 CHANGE STRUCTURE IDENTIFIER 

109 CHANGE STRUCTURE REFERENCES 

1 10 CHANGE STRUCTURE IDENTIFIER AND REFERENCES 

111 POST STRUCTURE 

112 UNPOST STRUCTURE 

113 UNPOST ALL STRUCTURES 

1 14 OPEN ARCHIVE FIL E 

115 CLOSE ARCHIVE FILE 

116 ARCHIVE STRUCTURES 

1 17 ARCHIVE STRUCTURE NETWORKS 
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Number Function Name 

118 ARCHIVE ALL STRUCTURES 

1 19 SET CONFLICT RESOL UTION 

120 RETRIEVE STRUCTURE IDENTIFIERS 

121 RETRIEVE STRUCTURES 

122 RETRIEVE STRUCTURE NETWORKS 

123 RETRIEVE ALL STRUCTURES 

124 RETRIEVE ANCESTORS OF STRUCTURE 

125 RETRIEVE DESCENDANTS OF STRUCTURE 

126 DELETE STRUCTURES FROM ARCHIVE 

111 DELETE STRUCTURE NETWORKS FROM ARCHIVE 

128 DELETE ALL STRUCTURES FROM ARCHIVE 

129 SET PICK IDENTIFIER 

130 SET PICK FILTER 

13 1 INITIALIZE LOCA TOR 3 

132 INITIALIZE LOCA TOR 

133 INITIALIZE STROKE 3 

134 INITIALIZE STROKE 

135 INITIALIZE VALUATOR 3 

136 INITIALIZE VALUATOR 

137 INITIALIZE CHOICE 3 

138 INITIALIZE CHOICE 

139 INITIALIZE PICK 3 

140 INITIALIZE PICK 

141 INITIALIZE STRING 3 ft 

142 INITIALIZE STRING 

143 SE7 L 0C4 TOR MODE 

144 SET STROKE MODE 

145 SET ML LM TOR MODE 

146 SET CHOICE MODE 

147 SET PICK MODE 

148 SET STRING MODE 

149 REQUEST LOCATOR 3 

1 50 REQUEST L OCA TOR 

151 REQUEST STROKE 3 

152 REQUEST STROKE 

153 REQUEST VALUATOR 

154 REQUEST CHOICE 

155 REQUEST PICK 

156 REQUEST STRING 

157 SAMPLE LOCATOR 3 

158 SAMPLE LOCATOR 

1 59 SAMPLE STROKE 3 
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Number Function Name 

160 SAMPLE STROKE 

161 SAMPLE VALUATOR 

162 SAMPLE CHOICE 

163 SAMPLE PICK 

164 SAMPLE STRING 

165 AWAIT EVENT 

166 PL USH DEVICE EVENTS 

167 GET LOCATOR 3 

168 GET LOCATOR 

169 GET STROKE 3 

170 GET STROKE 

171 GET V/U.L7/4 TOR 

172 GET CHOICE 

173 GET PICK 

174 GET STRING 

175 IW?/TE /TEM TO METAFILE 

176 GET /TEM TYPE EROM METAFILE 
111 READ ITEM FROM METAFILE 

178 INTERPRET ITEM 

179 SET ERROR HANDLING MODE 

180 ESCAPE 

201 POLYLINE SET 3 WITH DATA (+) 

202 FILL AREA 3 WITH DATA (+) 

203 FILL AREA SET 3 WITH DATA (+) 

205 TRIANGLE STRIP 3 WITH DATA (+) 

206 QUADRILA TERAL MESH 3 WITH DA TA (+) 

207 POLYHEDRON 3 WITH DATA (+) 

208 NON-UNIFORM B-SPLINE CUR VE (+) 

210 NON-UNIFORM B-SPLINE SURFACE (+) 

21 1 EXTENDED CELL ARRAY 3 (+) 

212 COMPUTE FILL AREA SET GEOMETRIC NORMAL (+) 

213 SET DEPTH CUE INDEX (+) 

216 SET AREA PROPERTIES (+) 

217 SET BACK AREA PROPERTIES (+) 

218 SET POLYLINE SHADING METHOD (+) 

220 SET BACK INTERIOR STYLE (+) 

221 SET BACK INTERIOR STYLE INDEX (+) 

222 SET INTERIOR SHADING METHOD (+) 

223 SET BACK INTERIOR SHADING METHOD (+) 

224 SET INTERIOR REFLECTANCE EQUATION (+) 

225 SET BACK INTERIOR REFLECTANCE EQUATION (+) 

226 SET LIGHT SOURCE STATE (+) 
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Number Function Name 

227 SET FACE DISTINGUISHING MODE (+) 

228 SET FACE CULLING MODE (+) 

229 SET POLYLINE COLOUR (+) 

230 SET POLYMARKER COLOUR (+) 

231 SET TEXT COLOUR (+) 

232 SET INTERIOR COLOUR (+) 

233 SET BACK INTERIOR COLOUR (+) 

234 SET EDGE COLOUR (+) 

235 SET CURVE APPROXIMA TION CRITERIA (+) 

236 SET TRIMMING CURVE APPROXIMATION CRITERIA (+) 

237 SET SURFACE APPROXIMA TION CRITERIA (+) 

239 SET EXTENDED POL YLINE REPRESENTA TION (+) 

240 SET EXTENDED POL YMARKER REPRESENTATION (+) 

24 1 SET EXTENDED TEXT REPRESENTA TION (+) 

242 SET EXTENDED EDGE REPRESENTA TION {+) 

243 SET EXTENDED INTERIOR REPRESENTA TION (+) 

245 SET EXTENDED PA TTERN REPRESENTA TION (+) 

246 SET DEPTH CUE REPRESENTATION (+) 

247 SET LIGHT SOURCE REPRESENTATION (+) 
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Error Messages 

The numbers in the left-hand column are returned by error messages, and the corresponding 
error description is listed in the right-hand column. 

Error Description 

-317 X Bad Implementation Error. 

-316 X Bad Length Error. 

-315 X Bad Name Error. 

-3 14 X Bad ID Choice Error. 

-313 X Bad GC Error. 

-312 X Bad Colour Error. 

-311 X Bad Alloc Error. 

-310 X Bad Access Error. 

-309 X Bad Drawable Error. 

-308 X Bad Match Error. 

-307 X Bad Font Error. 

-306 X Bad Cursor Error. 

-305 X Bad Atom Error. 

-304 X Bad Pixmap Error. 

-303 X Bad Window Error. 

-302 X Bad Value Error. 

-30 1 X Bad Request Error. 

-264 PEX output command error. 

-263 PEX structure error. 

-262 PEX search context error. 

-26 1 PEX renderer error. 

-260 PEX pipeline context error. 

-259 PEX pick measure error. 

-258 PEX PHIGS workstation error. 

-257 PEX font error. 

-256 PEX path error. 

-255 PEX name set error. 

-254 PEX lookup table error. 

-253 PEX label error. 

-252 PEX floating point format error. 

-25 1 PEX rendering state error. 

-250 PEX colour type error. 

-202 Ignoring function. An X allocation error has occurred. 

-201 Ignoring function. The specified X Server does not support a compatible PEX exten- 
sion. 

-200 Ignoring function. Cannot connect to the designated or default server. 

-167 Ignoring function. Opening this workstation would exceed the maximum number of 
simultaneously open canvas region workstations on a canvas. 

-165 Ignoring function. The length of specified edge data lists is inconsistent with the 
length of corresponding vertices lists. 

-164 Ignoring function. The specified number of vertices or sets of vertices is less than 
zero. 
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Error Description 

-163 Ignoring function. The specified edge flag is invalid. 

-162 Ignoring function. The specified vertex flag is invalid. 

-161 Ignoring function. The specified facet flag is invalid. 

-160 Ignoring function. The specified function is not available on the specified worksta- 
tion. 

-159 Ignoring function. The requested information is not available. 

-157 Warning. The specified GDP is not available on one or more workstations in this im- 
plementation. The GDP will be processed by those workstations on which it is avail- 
able. 

-156 Ignoring function. Specified font is not available for character set. 

- 1 55 Specified character set is invalid. 

-153 List length is less than zero. Zero will be used. 

-152 Ignoring function. Not implemented. 

-151 Ignoring function. Nameset or filter contains name outside supported range. 

- 150 Ignoring function. The specified number of points or sets of points is less than zero. 

-100 Ignoring function. Workstation type is a default type or bound to a workstation 
and cannot be modified. 

-57 Kernel not configured with shared-memory. PC facility needed for PEX SI commu- 
nication. 

-55 Ignoring function. Cannot open PHIGS. Cannot open font files. 

-54 Ignoring function. Cannot locate SI support file. 

-53 Ignoring function. SI support file path invalid. 

-52 Ignoring function. PEXAPIDIR path is too long. 

-51 Ignoring function. Cannot open PHIGS. Cannot locate SI file phigsmon. 

-50 Communication error. 

-6 Could not allocate additional dynamic memora during structure traversal. 

-2 Ignoring function. Cannot open PHIGS. Cannot create server. 

-1 Ignoring function. Cannot open PHIGS. Cannot create communication channel. 

No error. 

1 Ignoring function. Function requires state (PHCL,WSCL,STCL,ARCL). 

2 Ignoring function. Function requires state (PHOP,* ,*,*). 

3 Ignoring function. Function requires state (PHOP,WSOP,*,*). 

4 Ignoring function. Function requires state (PHOP,WSCL,STCL,ARCL). 

5 Ignoring function. Function requires state (PHOP,*, STOP,*). 

6 Ignoring function. Function requires state (PHOP,*,STCL,*). 

7 Ignoring function. Function requires state (PHOP,*,*,AROP). 

50 Ignoring function. Connection identifier not recognized by the implementation. 

51 Ignoring function. This information is not yet available for this generic worksta- 
tion type. Open a workstation of this type and use the specific workstation type. 

52 Ignoring function. Workstation type not recognized by the implementation. 

53 Ignoring function. Workstation identifier already is in use. 

54 Ignoring function. The specified workstation is not open. 

55 Ignoring function. Workstation cannot be opened for an implementation dependent 
reason. 

56 Ignoring function. Specified workstation is not of category MO. 
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Error Description 

57 Ignoring function. Specified workstation is of category Ml. 

58 Ignoring function. Specified workstation is not of category Ml. 

59 Ignoring function. The specified workstation does not have output capability (i.e., 
the workstation category is neither OUTPUT, OUTIN, nor MO). 

60 Ignoring function. Specified workstation is not of category OUTIN. 

61 Ignoring function. Specified workstation is neither of category INPUT nor of cate- 
gory OUTIN. 

62 Ignoring function. This information is not available for this MO workstation type. 

63 Ignoring function. Opening this workstation would exceed the maximum number of 
simultaneously open workstations. 

64 Ignoring function. The specified workstation type is not able to generate the speci- 
fied generalized drawing primitive. 

100 Ignoring function. The bundle index value is less than one. 

101 The specified representation has not been defined. 

102 Ignoring function. The specified representation has not be predefined on this work- 
station. 

103 Ignoring function. Setting this bundle table entry would exceed the maximum num- 
ber of entries allowed in the workstation bundle table. 

104 Ignoring function. The specified linetype is not available on the specified worksta- 
tion. 

105 Ignoring function. The specified marker type is not available on the specified work- 
station. 

106 Ignoring function. The specified font is not available for the requested text preci- 
sion on the specified workstation. 

107 Ignoring function. The specified edgetype is not available on the specified worksta- 
tion. 

108 Ignoring function. The specified interior style is not available on the workstation. 

109 Ignoring function. Interior style PATTERN is not supported on the workstation. 

1 10 Ignoring function. The specified colour model is not available on the workstation. 

111 Ignoring function. The specified HLHSR mode is not available on the specified 
workstation. 

1 12 Ignoring function. The pattern index value is less than one. 

1 13 Ignoring function. The colour index value is less than zero. 

114 Ignoring function. The view index value is less than zero. 

115 Ignoring function. The view index value is less than one. 

116 Ignoring function. One of the dimensions of pattern colour array is less than 1 . 

1 17 Ignoring function. One of the dimensions of the colour index array is less than 0. 

118 Ignoring function. One of the components of the colour specification is out of 
range. The valid range is dependent upon the current colour mode. 

1 19 Ignoring function. Depth cue index is less than 0. 

120 Ignoring function. Depth cue index is less than 1. 

122 Ignoring function. The specified polyline shading method is not available on the 
workstation. 

123 Ignoring function. The specified interior shading method is not available on the 
workstation. 
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Error Description 

124 Ignoring function. The specified interior reflectance equation is not available on the 

workstation. 
129. Ignoring function. The light source index is less than 1. 

130 Ignoring function. Invalid reference planes. DQMIN > DQMAX. 

131 Ignoring function. The specified light source type is not available on the worksta- 
tion. 

132 Ignoring function. The specified spot light spread angle is out of range. 

133 Ignoring function. One of the entries in the activation list or the deactivation list is 
less than 1. 

135 Ignoring function. The same entry exists in both the activation and the deactivation 
list. 

150 Ignoring function. Setting this view table entry would exceed the maximum num- 
ber of entries allowed in the workstation's view table. 

151 Ignoring function. Invalid window. XMIN > XMAX, YMIN > YMAX, or 
ZMIN > ZMAX. 

152 Ignoring function. Invalid viewport. XMIN > XMAX, YMIN > YMAX, or 
ZMIN > ZMAX. 

153 Ignoring function. Invalid view clipping limits. XMIN > XMAX, YMIN > 
YMAX, or ZMIN > ZMAX. 

154 Ignoring function. The view clipping limits are not within NPC range. 

155 Ignoring function. The projection viewport limits are not within NPC range. 

156 Ignoring function. The workstation window limits are not within NPC range. 

157 Ignoring function. The workstation viewport is not within display space. 

158 Ignoring function. Front plane and back plane distances are equal when z-extent of 
the projection viewport is 0. g * 

159 Ignoring function. The view plane normal vector has length 0. 

160 Ignoring function. The view up vector has length 0. 

161 Ignoring function. The view up and view plane normal vectors are parallel thus the 
viewing coordinate system cannot be established. 

162 Ignoring function. The projection reference point is between the front and back 
planes. 

163 Ignoring function. The projection reference point cannot be positioned on the view 
plane. 

164 Ignoring function. The back plane is in front of the front plane. 

200 Warning. Ignoring structures that do not exist. 

201 Ignoring function. The specified structure does not exist. 

202 Ignoring function. The specified element does not exist. 

203 Ignoring function. Specified starting path not found in CSS. 

204 Ignoring function. Specified search ceiling index out of range. 

205 Ignoring function. The label does not exist in the open structure between the ele- 
ment pointer and the end of the structure. 

206 Ignoring function. One or both of the labels does not exist in the open structure be- 
tween the element pointer and the end of the structure. 

207 Ignoring function. The specified path depth is less than 0. 

208 Ignoring function. The display priority is out of range. 
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Error Description 

250 Ignoring function. The specified device is not available on the specified workstation. 

251 Ignoring function. The function requires the input device to be in REQUEST mode. 

252 Ignoring function. The function requires the input device to be in SAMPLE mode 

253 Warning. The specified prompt/echo type is not available on the specified worksta- 
tion. Prompt/echo type one will be used in its place. 

254 Ignoring function. Invalid echo area/volume. XMIN > XMAX, YMIN > 
YMAX,orZMIN>ZMAX. 

255 Ignoring function. One of the echo area/volume boundary points is outside the range 
of the device. 

256 Warning. One input queue has overflowed. 

257 Ignoring function. Input queue has not overflowed. 

258 Warning. Input queue has overflowed, but associated workstation has been closed. 

259 Ignoring function. The input device class of the current input report does not match 
the class being requested. _ 

260 Ignoring function. One of the fields within the input device data record is in error. 

261 Ignoring function. Initial value is invalid. 

262 Ignoring function. Number of points in the initial stroke is greater than the buffer 
size. 

263 Ignoring function. Length of the initial string is greater than the buffer size. 

300 Ignoring function. Item type is not allowed for user items. 

301 Ignoring function. Item length is invalid. 

302 Ignoring function. No item is left in Metafile input. 

303 Ignoring function. Metafile item is invalid. 

304 Ignoring function. Item type is unknown. 

305 Ignoring function. Content of item data record is invalid for the specified item type. 

306 Ignoring function. Maximum item data record length is invalid. 

307 Ignoring function. User item cannot be interpreted. 

350 Warning. The specified escape is not available on one or more workstations in this 
implementation. The escape will be processed by those workstations on which it is 
available. 

351 Ignoring function. One of the fields within the escape data record is in error. 

400 Ignoring function. The archive file cannot be opened. 

401 Ignoring function. Opening this archive file would exceed the maximum number of 
simultaneously open archive files. 

402 Ignoring function. Archive file identifier already in use. 

403 Ignoring function. The archive file is not a PHIGS archive file. 

404 Ignoring function. The specified archive file is not open. 

405 Ignoring function. Name conflict occurred while conflict resolution flag has value 
ABANDON. 

406 Warning. The archive file is full. Any structures that were archived were archived 
in total. 

407 Warning. Some of the specified structures do not exist on the archive file. 

408 Warning. Some of the specified structures do not exist on the archive file. PHIGS 
will create empty structures in their places. 

450 Ignoring function. The specified error file is invalid. 
500 Ignoring function. The specified order is less than 1. 
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Error Description 

501 Ignoring function. Not enough control points for specified order. 

502 Ignoring function. The specified order is inconsistent with number of knots and con- 
trol points. 

503 Ignoring function. The knot sequence is not non-decreasing. 

504 Ignoring function. One or more of the vertex indices is out of range. 

505 Warning. The fill area is degenerate. 

506 Ignoring function. Parameter range is inconsistent with the knots. 

900 Storage overflow has occurred in PfflGS. 

901 Storage overflow has occurred in CSS. 

902 Input/Output error has occurred while reading. 

903 Input/Output error has occurred while writing. 

904 Input/Output error has occurred while sending data to a workstation. 

905 Input/Output error has occurred while receiving data from a workstation. 

906 Input/Output error has occurred during program library management. 

907 Input/Output error has occurred while reading workstation description table. 
90S Arithmetic error has occurred. 

2200 Buffer overflow in input or inquiry function. 

2201 Start index out of range. 

2000 Ignoring function. Enumeration type out of range. 

2001 Ignoring function. Output parameter size insufficient. 

2002 Ignoring function. List or set element not available. 

2003 Ignoring function. Invalid data record. 

2004 Ignoring function. Input parameter size out of range. 

2005 Ignoring function. Invalid list of point lists. 

2006 Ignoring function. Invalid list of filters. 
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PHIGS/PHIGS PLUS Tables 



PHIGS Description Table 

Data Type Abbreviations 



I 


Integer 


E 


Enumeration Type 


L(type) 


List of Values of a Given Type 


MCV 


Modeling Clipping Volume 


P3 


3D Point 


R 


Real 


SET(NM) 


Set of Eligible Names 


V2/V3 


2D/3D Vector 


W 


Workstation Type 


n/s 


Not Supported 


PHIGS DescriDtion Table Entry 



number of available workstation types 

list of available workstation types 

maximum number of simultaneously open workstations 

maximum number of simultaneously open archive files 

number of available names for name sets 

number of available character sets 

character set 
maximum length of normal filter list for ISS 
maximum length of inverted filter list for ISS 
polyline index 
linetype 

linewidth scale factor 
polyline colour index 
linetype ASF 

linewidth scale factor ASF 
polyline colour index ASF 
polymarker index 
marker type 
marker size scale factor 
polymarker colour index 
marker type ASF 
marker size scale factor ASF 
polymarker colour index ASF 
text index 
text font 



Data Type 


Default or Initial Value 


I 


1 


L(W) 


See Table 1 




14 









64 




1 









n/s 




n/s 




1 




1 


R 


1.0 


I 


1 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


I 


1 


I 


3 


R 


1.0 


I 


1 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


I 


1 


I 


1 (Monospaced 
Roman Simplex) 
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PHIGS Description Table Entry 

text precision 

character expansion factor 

character spacing 

text colour index 

text font ASF 

text precision ASF 

character expansion factor ASF 

character spacing ASF 

text colour index ASF 

character height 

character up vector 

character width 

character base vector 

text path 

text alignment (horizontal & vertical) 

annotation text character height 

annotation text character up vector 

annotation text character width 

annotation text character base vector 

annotation text path 

annotation text alignment (horizontal & vertical) 

annotation style 

interior index 

interior style 

interior style index 

interior colour index 

interior style ASF 

interior style index ASF 

interior colour index ASF 

edge index 

edge flag 

edgetype 

edgewidth scale factor 

edge colour index 

edge flag ASF 

edgetype ASF 

edgewidth scale factor ASF 

edge colour index ASF 

pattern size 



Data Tvoe 


Default or Initial Value 


E 


STROKE 


R 


1.0 


R 


0.0 


I 


1 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


R 


0.01 


V2 


(0.0,1.0) 


R 


n/s 


V2 


n/s 


E 


RIGHT 


2xE 


(NORMAL,NORMAL) 


R 


0.01 


V2 


(0.0,1.0) 


R 


n/s 


V2 


n/s 


E 


RIGHT 


2xE 


(NORMAL,NORMAL) 


I 
I 


1 (unconnected) 


1 


E 


HOLLOW 


I 


1 


I 


1 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


I 


1 


E 


OFF 


I 


1 


R 


1.0 


I 


1 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


2xR 


n/s 
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PHIGS Description Table Entry 

pattern reference point 

pattern reference vectors 

pick identifier 

view index 

HLHSR identifier 

name set 

global modelling transformation 

local modelling transformation 

modelling clipping volume 

modelling clipping indicator 

number of available generalized structure elements 

maximum number of distinct planes in modelling clipping 

volumes 

number of available modelling clipping operators 

list of available modelling clipping operators 



Data Type 


Default or Initial Value 


P3 


n/s 


2xV3 


n/s 


I 





I 





I 





SET(NM) 


no classes (empty set) 


4x4xR 


Identity 


4x4xR 


Identity 


MCV 


n/s 


E 


NOCLIP 


I 





I 





I 







empty 



34 



PHIGS PLUS Description Table 

Data Type Abbreviations 



I 


Integer 


E 


Enumeration Type 


GCOLR 


General Colour 


L(type) 


List of Values of a Given Type 


MCV 


Modeling Clipping Volume 


P3 


3D Point 


R 


Real 


SET(NM) 


Set of Eligible Names 


V2/V3 


2D/3D Vector 


W 


Workstation Type 


n/s 


Not Supported 


PHIGS PLUS Descriotion Table Entrv 



polyline colour 

polyline shading method 

polyline shading method ASF 

polymarker colour 

text colour 

face distinguishing mode 

face culling mode 

interior colour 

interior shading method 

ambient reflection coefficient 

diffuse reflection coefficient 

specular reflection coefficient 

specular colour 

specular exponent 

reflectance characteristics 

interior shading method ASF 

reflectance properties ASF 

reflectance characteristics ASF 

back interior style 

back interior style index 

back interior colour 

back interior shading method 

back ambient reflection coefficient 

back diffuse reflection coefficient 

back specular reflection coefficient 

back specular colour 

back specular exponent 



Data TvDe 


Default or Initial Value 


GCOLR 


(RGB, WHITE) 


I 


l(NONE) 


E 


INDIVIDUAL 


GCOLR 


(RGB ,WHITE) 


GCOLR 


(RGB WHITE) 


E 


NONE 


E 


NONE 


GCOLR 


(RGB WHITE) 


I 


l(NONE) 


R .J- ' 


1.0 


R 


1.0 


R 


1.0 


GCOLR 


(RGB WHITE) 


R 


0.0 


I 


l(NONE) 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


E 


HOLLOW 


I 


1 


GCOLR 


(RGB WHITE) 


I 


l(NONE) 


R 


1.0 


R 


1.0 


R 


1.0 


GCOLR 


(RGB WHITE) 


R 


0.0 
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PHIGS PLUS Description Table Entry 

back reflectance characteristics 

back interior style ASF 

back interior style index ASF 

back interior colour ASF 

back interior shading method ASF 

back reflectance properties ASF 

back reflectance characteristics ASF 

light source state 

edge colour 

curve approximation criteria type 

curve approximation criteria value 

curve approximation criteria ASF 

surface approximation criteria type 

surface approximation criteria value 

surface approximation criteria ASF 

rendering colour model 

depth cue index 

colour mapping index 



Data Type 


Default or Initial Value 


I 


l(NONE) 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


E 


INDIVIDUAL 


L(I) 


empty 


GCOLR 


(RGB, WHITE) 


I 


or n/s 


R 


or n/s 


E 


INDIVIDUAL 


I 


n/s 


2xR 


n/s 


E 


n/s 


I 


n/s 


I 





I 


n/s 
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PHIGS Workstation Description Table 

Data Type Abbreviations 



B 


Bounding Range 


CC 


Chromaticity Coefficient 


D 


Data Record 


E 


Enumeration Type 


FP 


Font/Precision Pair 


I 


Integer 


L(type) 


List of values of a given type 


P3 


3D Point 


R 


Real 


n/s 


Not Supported 


PHIGS Workstation Description Table Entry 



workstation type 
workstation category 
device coordinate units 
maximum display space size: 

in device coordinates 

in device address units 

number of available HLHSR identifiers 

list of available HLHSR identifiers 

number of available HLHSR modes 

list of available HLHSR modes 

number of predefined view indices (representations) 

table of predefined view representations: 

view orientation matrix 

view mapping matrix 

view clipping limits 

x-y clipping indicator 

back clipping indicator 

front clipping indicator 
workstation classification 
dynamic modification accepted for: 

view representation 

polyline bundle representation 

polymarker bundle representation 

text bundle representation 

interior bundle representation 

edge bundle representation 

pattern representation 



Data Type 


Initial Value 


W 


See Table 1 


E 


See Table 1 


E 


OTHER 


3xR 


(1.0,1.0,1.0) 


3x1 


(1280,1024, 

24 z-buffer planes) 


I 


2 


L(I) 


NONE,ZBUFF 


I 


2 


L(I|. * 


NONE,ZBUFF 


I 


6 


4x4xR 


Identity 


4x4xR 


Identity 


3xB 


(0,1,0,1,0,1) 


E 


CLIP 


E 


CLIP 


E 


CLIP 


E 


RASTER 


E 


IRG 


E 


IRG 


E 


IRG 


E 


IRG 


E 


IRG 


E 


IRG 


E 


IRG 
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PHIGS Workstation Description Table Entry 

colour representation: 

workstation transformation 

highlighting filter 

invisibility filter 

HLHSR mode 
default value for deferral state: 

deferral mode 

modification mode 
number of available linetypes 
number of available linewidths 
nominal linewidth 
minimum linewidth 
maximum linewidth 

number of predefined polyline indices (bundles) 
table of predefined polyline bundles 
number of available marker types 
list of available marker types 
number of available marker sizes 
nominal marker size 
minimum marker size 
maximum marker size 

number of predefined polymarker indices (bundles) 
table of predefined polymarker bundles 
number of text font and precision pairs 
list of text font and precision pairs 
number of available character expansion factors 
minimum character expansion factor 
maximum character expansion factor 
number of available character heights 
minimum character height 
maximum character height 
number of predefined text indices (bundles) 
table of predefined text bundles 
number of available annotation styles 
list of available annotation styles 
number of available interior styles 
list of available interior styles 
number of available hatch styles 
list of available hatch styles 



Data Type 


Initial Value 


E 


IRG 


E 


IRG 


E 


IRG 


E 


IRG 


E 


IRG 


E 


ASAP 


E 


NIVE 


L(I) 


See Table 2 


I 


1 


R 


1.0 (pixel) 


R 


1.0 


R 


1.0 


I 


5 




See Table 3 


I 


8 


L(I) 


See Table 4 


I 


(continuous) 


R 


1.0 (9 pixels) 


R 





R 


unlimited 


I 


5 




See Table 5 


I 


4 


L(FP) 


See Table 6 


I 


(continuous) 


R 


0.0 


R 


unlimited 


I 


(continuous) 


R 


0.0 


R 


unlimited 


I 


6 




See Table 7 


I 


2 


L(I) 


See Table 12 


I 


3 


L(E) 


See Table 8 


I 





L(I) 


empty 
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PHIGS Workstation Description Table Entry Data Type 

number of predefined interior indices (bundles) I 

table of predefined interior bundles 

number of available edgetypes I 

list of available edgetypes L(I) 

number of available edgewidths I 

nominal edgewidth R 

minimum edgewidth R 

maximum edgewidth R 

number of predefined edge indices (bundles) I 

table of predefined edge bundles 

number of predefined pattern indices (representations) I 

table of predefined pattern representations 

number of available colour models I 

list of available colour models L(I) 

default colour model I 

colour available E 

number of predefined colour indices (representations) I 

table of predefined colour representations 

number of available generalized drawing primitives 3 (GDP3) I 

list of available generalized drawing primitives 3 (GDP3) 

number of available generalized drawing primitives (GDP) I 

list of available generalized drawing primitives (GDP) 

number of display priorities supported I ^ 

maximum number of polyline bundle table entries I 

maximum number of polymarker bundle table entries I 

maximum number of text bundle table entries I 

maximum number of interior bundle table entries I 

maximum number of edge bundle table entries I 

maximum number of pattern table entries I 

maximum number of colour indices I 

maximum number of view indices I 

dynamic modification accepted for: 

structure content modification E 

post structure E 

unpost structure E 

delete structure E 

reference modification E 

number of logical devices of class LOCATOR I 

number of logical input devices of class STROKE I 



Initial Value 

5 

See Table 9 

4 

See Table 2 

1 

1.0 (pixel) 

1.0 

1.0 

5 

See Table 10 



empty 

2 

1 (RGB) 

1 (RGB) 

COLOUR 

8 

See Table 11 



empty 



empty 

(unlimited) 

20 

20 

20 

20 

20 



256 

20 

IRG 

IRG 

IRG 

IRG 

IRG 
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PHIGS Workstation Description Table Entry 

number of logical input devices of class VALUATOR 
number of logical devices of class CHOICE 
number of logical input devices of class PICK 
number of logical input devices of class STRING 



Data Type 


Initial Value 


I 





I 





I 





I 
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PHIGS PLUS Workstation Description Table 


Data Tvpe Abbreviations 


B 


Bounding Range 


CC 


Chromaticity Coefficient 


D 


Data Record 


E 


Enumeration Type 


FP 


Font/Precision Pair 


I 


Integer 


L(type) 


List of values of a given type 


P3 


3D Point 


R 


Real 


n/s 


Not Supported 


PHIGS PLUS Workstation Description Table Entrv 



number of available directly specifiable colour models 
list of available directly specifiable color models 
number of available rendering colour models 
list of available rendering colour models 
dynamic modification accepted for: 

data mapping representation 

reflectance representation 

parametric surface representation 

light source representation 

depth cue representation 

colour mapping representation 
table of predefined polyline bundles 
table of predefined polymarker bundles 
table of predefined text bundles 
table of predefined interior bundles 
table of predefined edge bundles 
maximum number of data mapping bundle table entries 
number of predefined data mapping bundles 
maximum number of reflectance bundle table entries 
number of predefined reflectance bundles 
for every entry: 

reflectance index 

reflectance characteristics 

ambient reflection coefficient 

diffuse reflection coefficient 

specular reflection coefficient 

specular colour 

specular exponent 



Data Type 

I 
I 
I 
I 



E 
E 
E 
E 
E 
E 



I 
I 
I 
I 

I 

I 

R 

R 

R 

GCOLR 

R 



Initial Value 

1 (RGB) 
1 (RGB) 
1 (RGB) 
1 (RGB) 

IRG 

IRG 

IRG 

IRG 

IRG 

IRG 

See Table 3 

See Table 5 

See Table 7 

See Table 9 

See Table 10 

n/s 

n/s 

20 

1 

1 

1 

1.0 

1.0 

1.0 

1 

1.0 
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PHIGS PLUS Workstation Description Table Entry 

maximum number of parametric surface bundle table entries 

number of predefined parametric surface bundles 

number of predefined pattern representations 

maximum number of light source table entries 

number of predefined light source table indices 

table of predefined light sources 

maximum number of depth cue table entries 

number of predefined depth cue indices 

table of predefined depth cue representations 

maximum number of colour mapping table entries 

number of predefined colour mapping table entries 

table of predefined colour mappings 

number of available polyline shading models 

list of available polyline shading methods 

number of available interior styles 

number of available data mapping methods 

list of available data mapping methods 

number of available interior shading methods 

list of available interior shading methods 

number of available reflectance characteristics values 

list of available reflectance characteristics 

maximum non-uniform b-spline curve order 

maximum trimming curve order 

number of available curve approximation criteria types 

list of available curve approximation criteria types 

maximum non-uniform b-spline surface order 

number of available surface approximation criteria types 

list of available surface approximation criteria types 

number of available trimming curve approximation criteria types 

list of available trimming curve approximation criteria types 

number of available parametric surface 

characteristics types 

list of available parametric surface 

characteristics types 

number of available light source types 

list of available light source types 

maximum number of simultaneously active 

non-ambient light sources 

number of available colour mapping methods 



Data Tvoe 


Initial Value 


I 


n/s 


I 


n/s 


I 





I 


12 


I 


1 




See Table 18 


I 


6 


I 


2 




See Table 17 


I 


n/s 


I 


(n/s) 




n/s 


I 


2 




See Table 13 




See Table 8 


I 


n/s 


L(I) 


n/s 


I 


2 


L(I) 


See Table 14 


I 


4 




See Table 16 


I 


n/s 


I 


(n/s) 


I 





L(I) 


n/s 


I 


(n/s) 


I 





L© 


n/s 


I 





L(I) 


n/s 



n/s 



L(I) 


n/s 


I 


4 




See Table 15 


I 


12 


I 


n/s 
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PHIGS PLUS Workstation Description Table Entry 

list of available colour mapping methods 

number of available true colours 
maximum number of pseudo colours entries 



Data Type 

LCD 

I 

I 



Initial Value 

n/s 
2 24 

n/s 
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Table 1. Workstation Type and Category 





Type C Name 


Category 






X drawable ph igs_ws _type_x_ 


_drawable output 






Table 2. Available Line and/or Edge Types 






Type C Name 


Meaning 






1 PLN_SOLID 


Solid 






2 PLN_DASH 


Dashed 






3 PLN_DOT 


Dotted 






4 PLN_DOTDASH 


Dot-dashed 






Table 3. Predefined Extended! Polyline Bundle Table 




Bundle 
Index 


Linetvpe Line Width Colour 
Scale Factor Index J 


Shading Approx. 
Methodt Typet 


Approx. 
Valuet 


1 


Solid 1.0 1 


None N/A 


N/A 



f PfflGS PLUS extension. 

$ All Predefined Extended Polymarker Bundle entries use colour model 
INDIRECT. 



Table 4. Available Marker Types 



Value 

1 

2 

3 

4 

5 



-1 

-2 



CName 


Meaning 


PMK_POINT 


Point 


PMK_PLUS 


Plus 


PMK_PSTAR 


Asterisk 


PMK_0 


Circle 


PMK_X 


Cross 


to be determined 


Asterisk 


to be determined 


Diamond 


to be determined 


Fast dot 



Table 5. Predefined Polymarker Bundle Table 

Bundle Marker Marker Size Colour 

Index Type Scale Factor Index t 

1 Asterisk 1.0 1 

f All Predefined Extended Polymarker Bundle entries (PHIGS PLUS extension) 
use colour model INDIRECT. 

Table 6. Available Text Fonts and Precisions 

Font Number CName Precisions Supported 

1 PFONT MONO STROKE 
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Table 7. Predefined Extended Text Bundle Table 



Bundle 
Index 

1 



Font 
Number 

1 



Text 
Precision 

STROKE 



Expansion 
Factor 

1.0 



Character 


Colour 


Spacing 
0.0 


Indext 
1 



t All Predefined Extended Polymarker Bundle entries (PHIGS PLUS extension) 
use colour model INDIRECT. 

Table 8. Available Interior Styles 

CName Meaning 

PHOLLOW Hollow 

PSOLID Solid-filled 

PEMPTY Empty 

Table 9. Predefined Fill Area Interior Bundle Table 

Bundle 
Index 

1 

f All Predefined Extended Edge Bundle entries (PHIGS PLUS extension) use 
colour model INDIRECT; have back attribute values identical to the front; and 
have the following area properties: 
Ambient Diffuse Specular Specular Specular Transparency 

Coefficient Coefficient Coefficient Colour Exponent Coefficient 

1.0 1.0 1.0 (RGB, 1.0, 1.0, 1.0) 0.0 0.0 

Table 10. Predefined Edge Bundle Table 

Bundle Index Edge Flag Edgetvpe Edgewidth S^ale Factor Colour Index t 
1 ON Solid 1.0 1 

tAll Predefined Extended Edge Bundle entries (PHIGS PLUS extension) use 
colour model INDIRECT. 



Interior 


Interior 


Colour 


Reflectance 


Shading 


Style 


Style Index 


Index 


Equationt 


Method 


Hollow 


1 


1 


None 


None 



Colour Index 


Red 





0.0 


1 


1.0 


2 


1.0 


3 


0.0 


4 


0.0 


5 


1.0 


6 


0.0 


7 


1.0 


>8 


1.0 



Table 11. Predefined Colour Table 

Green 

0.0 
1.0 
0.0 
1.0 
0.0 
1.0 
1.0 
0.0 
1.0 



Blue 


Description 


0.0 


Black 


1.0 


White 


0.0 


Red 


0.0 


Green 


1.0 


Blue 


0.0 


Yellow 


1.0 


Cyan 


1.0 


Magenta 


1.0 


White 
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Table 12. Available Annotation Styles 

Value CName Meaning 

1 PANJJNCON Unconnected 

2 PAN_LEADLINE Lead Line 

Table 13. Polyline Shading Methods 

Value CName Meaning 

1 PSD_NONE No Shading 

2 PSD_COLOUR Colour Shading 

Table 14. Available Interior Shading Methods 

Value CName Meaning 

1 PSD_NONE No Shading 

2 PSD_COLOUR Colour Shading 

Table 15. Available Light Source Types 

Value CName Meaning 

1 PLIGHT_AMBIENT Ambient Light Source 

2 PLIGHT_DIRECTION AL Directional Light Source 

3 PLIGHT_POSITIONAL Positional Light Source 

Table 16. Available Reflectance Characteristics 

Value CName Meaning 

1 PREFLJMONE No Reflectance Calculation Performed 

2 PREFL_AMBIENT Use Ambient Term 

3 PREFL_AMB_DIFF Use Ambient and Diffuse Terms 

4 PREFL_AMB_DIFF_SPEC Use Ambient, Diffuse, and Specular Terms 

Table 17. Predefined Depth Cue Table 

Depth Cue Depth Cue Depth Cue Depth Cue Depth Cue 

Index Mode Reference Planes Scale Factors Colour 






SUPPRESSED 


(0.0,1.0) 


(1.01.0) 


(INDIRECT.O) 





ALLOWED 


(0.0,1.0) 


(0.01.0) 


(INDIRECT.O) 



Table 18. Predefined Light Sources 

Index Type Data Record 

1 DIRECTIONAL (RGB,1.0,1.0,1.0),0.0,0.0,1.0 
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